home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / dtpaint.lzh / DTPAINT.ASC < prev   
Text File  |  1985-11-20  |  18KB  |  534 lines
  1.  
  2.  
  3. DTPaint Desk Accessory w/Active Windows v1.0md
  4. Monochrome Version
  5.  
  6. all code and documentation Copyright 1989, 1990 
  7. by Michael Bergman
  8.  
  9.  
  10.  
  11. Well, It's been a long year since I originally wrote ImageEditor 
  12. DA and I promised a more friendlier user interface.  I said that 
  13. it would take no longer than a couple of months and I was right.
  14. What I didn't bargain for was the time it would take to develop 
  15. some more sophisticated graphic tools.
  16.  
  17. What you have here is a demo version of that effort.  This desk 
  18. accessory does not save in .IMG format, although it will save 
  19. blocked images in a propriatary format.
  20.  
  21. You may have noticed that the only other file in the archive is 
  22. the desk accessory itself.  There are no "support files".  DTPaint 
  23. is totally self-sufficient.  All code, resources, and images are 
  24. embedded in the accessory.  This way, you are not surprised to 
  25. find that you have less memory that what you expected.  Also, it 
  26. makes resource handling a tad more stable.  
  27.  
  28. Over and over again I get the same questions:  "Why a desk 
  29. accessory?"  "Don't you think a desk accessory is less effective 
  30. than a 'real' program?"
  31.  
  32. The reason for a desk accessory paint program is that regular 
  33. paint programs are a dime a dozen.  You can probably name that 
  34. many right now, both commercial and shareware.  The idea of a desk 
  35. accessory paint program is to let you, the user, create or edit 
  36. pictures without having to leave the program you are currently 
  37. using.  This allows greater flexiblity of the environment and 
  38. interactivity with the current job.  In other words, you don't 
  39. have to quit the current job, start up another graphics creation 
  40. program, load the picture, edit, save, quit, load in the original 
  41. program, load the saved files and then load the editted picture.
  42. All you have to do is call up the desk accessory, edit a picture, 
  43. save it and import to your current program.  It almost qualifies 
  44. as a multitasking environment!
  45.  
  46. The differences between this program--DTPaint--and ImageEditor are 
  47. vast although DTPaint was borne from ImageEditor.  DTPaint is a 
  48. full paint program.  In other words, you can not only edit 
  49. existing pictures but create them from scratch as well.  I have 
  50. maintained some of the keycommands from ImageEditor, but 
  51. everything can be accessed from "The Menu" (press <Help> or select 
  52. the DTPaint desk accessory menu) and the Toolbox (press 
  53. <Alternate> t or select "Show Toolbox" from "The Menu").  Both 
  54. will pop-up under the mouse so you don't have to go hunting for 
  55. them.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                            Page 1 of 8
  67.  
  68. What is "Active Windows"?
  69.  
  70. Active Windows is a convenience feature.  It allows you to access 
  71. the Toolbox without actually having to click on it to activate it.  
  72. The Toolbox, if it is open, will automatically activate as soon as 
  73. the mouse leaves the picture window and will deactivate when the 
  74. mouse enters the work area of the picture, except if the mouse is 
  75. also over the Toolbox itself.  You can toggle the Active Windows 
  76. feature by pressing <F3>.  By making the Active Windows feature 
  77. "inactive", the windows will act just like every other GEM 
  78. windowing system.  If you do decide to use Active Windows, it is 
  79. best to keep the Toolbox up at the menu bar on the right.  That 
  80. way, you won't "lose" the Toolbox under a full window.  Just move 
  81. the move into the menu bar, wait for the Toolbox to activate then 
  82. bring the mouse over the Toolbox and make a selection or move the 
  83. Toolbox.
  84.  
  85.  
  86.  
  87.  
  88. How about a tour of DTPaint?
  89.  
  90. Let's start with "The Menu".  The easiest way is to press the 
  91. <Help> key and "The Menu" will appear under the mouse.  The 
  92. entres include:
  93.  
  94. About DTPaint            Brings up the obligatory "About..." box.
  95.  
  96. New                      Lets you create a new picture.
  97.  
  98. Load                     Load in an existing .IMG, MacPaint or 
  99.                          Degas Elite picture.
  100.  
  101. Quick Save               Saves the picture under the existing file 
  102.                          name.
  103.  
  104. Save As...               Lets you save the current picture under 
  105.                          another name.
  106.  
  107. Show/Hide Tools          Shows or hides the Toolbox.
  108.  
  109. Show Information         Shows picture's width, height, resolution 
  110.                          and compression.
  111.  
  112. Save Preferences         Lets you save the Tools' attributes and 
  113.                          memory configuration.
  114.  
  115. Memory                   Allows you to free or allocate memory 
  116.                          dynamically.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                            Page 2 of 8
  133.  
  134. Next, let's look at the Toolbox:
  135.  
  136. First off, the Toolbox, which should have come up under your mouse 
  137. (unless it is in the menu bar, in which case it will be just under 
  138. the menu bar), is movable.  All you have to do is press the left 
  139. mouse button anywhere in the Toolbox area and drag it across the 
  140. screen.  It should be noted that, although you can press the mouse 
  141. button anywhere in the Toolbox, if you presss it while the mouse 
  142. is above an icon or fill pattern or brush pattern, you will 
  143. activate that particular tool or pattern.  It is always best to 
  144. drag the Toolbox at the middle of the Toolbox, at the Fill Pattern 
  145. Display (at the bottom right corner) or on an active icon/tool.
  146.  
  147. Along the bottom of the Toolbox are the standard Atari fill 
  148. patterns.  All fill patterns are auto-locked which means that it 
  149. doesn't matter where the window is or what section of the picture 
  150. you are editing, the fill pattern will automaticlly lock onto the 
  151. left edge of the actual picture.  The program will adjust the fill 
  152. pattern to match the section of the picture you are working on.  
  153. The patterns are editable and loadable.  If you double-click on 
  154. one of the fill patterns you will get a dialogue box that will let 
  155. you edit the pattern, save it to file, or load in a new pattern 
  156. file.  When you exit the dialogue box, the new pattern will appear 
  157. in the box where the old one was and a 32 pixel representation 
  158. will appear in the Fill Pattern Display.  Next to the Fill Pattern 
  159. Display is a white and a black box.  The box that is outlined is 
  160. the active box.  By selecting these boxes, you can reverse the 
  161. colors of all of the fill patterns in the pallette.
  162.  
  163. At the top right corner are the brush patterns and the line 
  164. patterns.  You may only select or edit brush patterns when the 
  165. brush tool icon is active.  Brushes can be editted, saved and 
  166. loaded just like fill patterns.  In fact, their file formats are 
  167. identical so they can also be interchanged.  In other words, fill 
  168. patterns can be used as brush patterns and vice versa.
  169.  
  170. Line patterns can only selected when using the line, oval, arc, 
  171. pie, box, round box and polygon tool icons are active.  Line 
  172. patterns can only be editted.  They cannot be saved or loaded.
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                            Page 3 of 8
  199.  
  200. At the top left corner are the tool icons.  The are, from left to 
  201. right and top to bottom:
  202.  
  203. Pencil
  204.      Just a simple drawing tool used for scribbling and 
  205. scratching.  The Pencil has three modes:  black, white and 
  206. opposite.  Double-click on the Pencil icon and an alert box will 
  207. open up to let you choose which mode you want to use.  In the 
  208. opposite mode, the pencil will draw in the color opposite of the 
  209. color under the mouse when you press the left mouse button.  
  210. Release the left mouse button to stop drawing.
  211.  
  212. Brush
  213.      Use the brush patterns at the top right of the Toolbox plus 
  214. the fill patterns to brush patterns over the picture.  Press the 
  215. left mouse button and apply the "paint".  Release the left mouse 
  216. button to stop "painting".  The fills will be applied opaquely 
  217. unless you hold the <Alternate> key down when you first press the 
  218. left mouse button, then it will apply the fills transparently.
  219.  
  220. Airbrush
  221.      A random pixel changer that will change the pixel to fit the 
  222. chosen fill pattern.  The radius can be adjusted from 1 to 50 by 
  223. double-clicking on the Airbrush icon.  Hold the left mouse button 
  224. down while